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(54) Write anywhere file-system layout 

(57) The present invention provides a method for 
keeping a file system in a consistent state and for creat- 
ing read-only copies of a file system. Changes to the file 
system are tightly controlled. The file system 
progresses from one consistent state to another. The 
set of self-consistent blocks on disk that is rooted by the 
root inode is referred to as a consistency point. To 
implement consistency points, new data is written to 
unallocated blocks on disk. A new consistency point 
occurs when the fstnfb block (2440) is updated by writ- 
ing a new root inode for the inode file (1210) into it 
Thus, as long as the root inode is not updated, the state 
of the file system represented on disk does not change. 
The present invention also creates snapshots (Figure 
22) that are read-only copies of the ffle system. A snap- 
shot uses no disk space when it is initially created. It is 
designed so that many different snap shots can be cre- 
ated for the same file system. Unlike prior art file sys- 
tems that create a clone by duplicating the entire inode 
file and all of the indirect blocks, the present invention 
duplicates only the inode that describes the inode f fle. A 
multi-bit free-block map fOe (1630) is used to prevent 
data from being overwritten on disk. 
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Description 



[0001 ] The present invention is related to the field of 
methods and apparatus for maintaining a consistent ffle 
system and for creating read-only copies of the ffle sys- 
tem. 

[0002J All file systems must maintain consistency in 
spite of system failure. A number of different consist- 
ency techniques have been used in the prior art for this 
purpose. 

[0003] One of the most difficult and time consuming 
issues in managing any file server is making backups of 
file data. Traditional solutions have been to copy the 
data to tape or other off-line media. With some file sys- 
tems, the file server must be taken off-line during the 
backup process in order to ensure that the backup is 
completely consistent A recent advance in backup is 
the ability to quickly "clone" fi.e., a prior art method for 
creating a read-only copy of the file system on disk) a 
file system, and perform a backup from the clone 
instead of from the active file system. With this type of 
file system, it allows the file server to remain on-line dur- 
ing the backup. 

File System Consistency 

[00041 A prior art file system is disclosed by Chu- 
tani, et al. in an article entitled The Episode Fife 
System, USEN1X, Winter 1992, at pages 43-59. The 
article describes the Episode file system which is a file 
system using meta-data (i.e., inode tables, directories, 
bitmaps, and indirect blocks). It can be used as a stand- 
alone or as a distributed file system. Episode supports a 
plurality of separate file system hierarchies. Episode 
refers to the plurality of file systems collectively as an 
"aggregate". In particular, Episode provides a clone of 
each file system for slowly changing data. 
[00051 In Episode, each logical file system contains 
an "anode" table. An anode table is the equivalent of an 
inode table used in file systems such as the Berkeley 
Fast File System. It is a 252-byte structure. Anodes are 
used to store all user data as well as meta-data in the 
Episode file system. An anode describes the root direc- 
tory of a ffle system including auxiliary files and directo- 
ries. Each such file system in Episode is referred to as a 
Iflesef. All data within a fileset is locatable by iterating 
through the anode table and processing each file in 
turn. Episode creates a read-only copy of a file system, 
herein referred to as a "clone", and shares data with the 
active file system using Copy-On-Write (COW) tech- 
niques. 

[00061 Episode uses a logging technique to recover 
a file system(s) after a system crashes. Logging 
ensures that the file system meta-data are consistent A 
bitmap table contains information about whether each 
block in the file system is allocated or not. Also, the bit- 
map table indicates whether or not each block is logged. 
All meta-data updates are recorded in a log "container 



that stores transaction log of the aggregate. The log is 
processed as a circular buffer of disk blocks. The trans- 
action logging of Episode uses logging techniques orig- 
inally developed for databases to ensure file system 
5 consistency. This technique uses carefully order writes 
and a recovery program that are supplemented by data- 
base techniques in the recovery program. 
[0007] Other prior art systems including JFS of IBM 
and VxFS of Veritas Corporation use various forms of 
10 transaction logging to speed the recover process, but 
still require a recovery process. 
[00081 Another prior art method is called the 
"ordered write" technique. It writes all disk blocks in a 
carefully determined order so that damage is minimized 
is when a system failure occurs while performing a series 
of related writes. The prior art attempts to ensure that 
inconsistencies that occur are harmless. For instance, a 
few unused blocks or inodes being marked as allocated. 
The primary disadvantage of this technique is that the 
20 restrictions it places on disk order make it hard to 
achieve high performance. 

[00091 Yet another prior art system is an elaboration 
of the second prior art method referred to as an 
"ordered write with recovery" technique. In this method, 
25 inconsistencies can be potentially harmful. However, 
the order of writes is restricted so that inconsistencies 
can be found and fixed by a recovery program. Exam- 
ples of this method include the original UNIX file system 
and Berkeley Fast File System (FFS). This technique 
30 does reduce disk ordering sufficiently to eliminate the 
performance penalty of disk ordering. Another disad- 
vantage is that the recovery process is time consuming. 
It typically is proportional to the size of the file system. 
Therefore, for example, recovering a 5 GB FFS file sys- 
35 tern requires an hour or more to perform. 

Filp System Clones 



[00101 Figure 1 is a prior art diagram for the Epi- 
40 sode file system illustrating the use of copy-on-write 
(COW) techniques for creating a fileset clone. Anode 
110 comprises a first pointer 110A having a COW bit 
that is set Pointer 11 OA references data block 114 
directly. Anode 110 comprises a second pointer 11 0B 
45 having a COW bit that is cleared. Pointer 1 10B of anode 
references indirect block 112. Indirect block 112 com- 
prises a pointer 112A that references data block 124 
directly. The COW bit of pointer 112A is set. Indirect 
block 112 comprises a second pointer 112B that refer- 
so ences data block 126. The COW bit of pointer 112B is 

cleared. 

[001 1] A clone anode 120 comprises a first pointer 
120A that references data block 114. The COW bit of 
pointer 120A is cleared. The second pointer 120B of 
55 clone anode 120 references indirect block 122. The 
COW bit of pointer 120B is cleared. In turn, indirect 
block 122 comprises a pointer 122A that references 
data block 124. The COW bit of pointer 122A is cleared. 
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[001 2] As illustrated in Figure 1 , every direct pointer ' 
1 10A, 1 12A-1 12B, 120A, and 122A and indirect pointer 
11 OB and 120B in the Episode file system contains a 
COW bit, Blocks that have not been modified are con- 
tained in both the active file system and the done, and 
have set (1) COW bits. The COW bit is cleared (0) when 
a block that is referenced to by the pointer has been 
modified and, therefore, is part of the active file system 
but not the clone. 

[0013] When a copy-on-write block is modified, as 
shown in Figure 1, a new block is allocated and 
updated. The COW flag in the pointer to this new block 
is then set The COW bit of pointer 11 OA of original 
anode 1 10 is cleared. Thus, when the clone anode 120 
is created, pointer 120A of clone anode 120 references 
data block 1 14 also. Both original anode 1 10 and clone 
anode 120 reference data block 114. Data block 124 
has also been modified as indicated by a cleared COW 
bit of pointer 1 12A in original indirect block 112. Thus, 
when the clone anode is created, indirect block 122 is 
created. Pointer 122A of indirect block 122 references 
data block 124, and the COW bit of pointer 122A is 
cleared. Both indirect block 122 of the original anode 
1 1 0 and indirect block 1 22 of clone anode 1 20 reference 
data block 124. 

[0014] Figure 1 illustrates copying of an anode to 
create a clone anode 120 for a single file. However, 
clone anodes must be created for every file having 
changed data blocks in the file system. At the time of the 
clone, all inodes must be copied. Creating clone anodes 
for every modified fife in the file system can consume 
significant amounts of disk space. Further, Episode is 
not capable of supporting multiple clones since each 
pointer has only one COW bit. A single COW bit is not 
able to distinguish more than one clone. For more than 
one clone, there is not a second COW bit that can be 
set. 

[0015] A fileset "clone" is a read-only copy of an 
active fileset wherein the active fileset is readable and 
writable. Clones are implemented using COW tech- 
niques, and share data blocks with an active fileset on a 
block-by-block basis. Episode implements cloning by 
copying each anode stored in a fileset. When initially 
cloned, both the writable anode of the active fileset and 
the cloned anode both point to the same data blocks). 
However, the disk addresses for direct and indirect 
blocks in the original anode are tagged as COW. Thus, 
an update to the writable fileset does not affect the 
done. When a COW block is modified, a new block is 
allocated in the file system and updated with the modifi- 
cation. The COW flag in the pointer to this new block is 
cleared 

[001 6] The prior art Episode system creates clones 
that duplicate the entire inode file and all of the indirect 
blocks in the file system. Episode duplicates all inodes 
and indirect blocks so that it can set a Copy-On-Write 
(COW) bit in all pointers to blocks that are used by both 
the active file system and the clone. In Episode, it is 



important to identify these blocks so that new data writ- 
ten to the active file system does not overwrite "old" 
data that is part of the clone and, therefore, must not 
change. 

5 [0017] Creating a clone in the prior art can use up 
as much as 32 MB on a 1 GB disk The prior art uses 
256 MB of disk space on a 1 GB disk (for 4 KB blocks) 
to keep eight clones of the file system. Thus, the prior 
art cannot use large numbers of clones to prevent loss 

ro of data. Instead it used to facilitate backup of the file 
system onto an auxiliary storage means other than the 
disk drive, such as a tape backup device. Clones are 
used to backup a file system in a consistent state at the 
instant the clone is made. By cloning the file system, the 

75 clone can be backed up to the auxiliary storage means 
without shutting down the active file system, and 
thereby preventing users from using the file system. 
Thus, clones allow users to continue accessing an 
active file system while the file system, in a consistent 

20 state is backed up. Then the clone is deleted once the 
backup is completed. Episode is not capable of support- 
ing multiple clones since each pointer has only one 
COW bit A single COW bit is not able to distinguish 
more than one clone. For more than one clone, there is 

25 no second COW bit that can be set 

[0018] A disadvantage of the prior art system for 
creating file system clones is that it involves duplicating 
all of the inodes and all of the indirect blocks in the file 
system. For a system with many small files, the inodes 

30 alone can consume a significant percentage of the total 
disk space in a file system. For example, a 1 GB file sys- 
tem that is filled with 4 KB files has 32 MB of inodes. 
Thus, creating an Episode clone consumes a significant 
amount of disk space, and generates large amounts 

35 (i.e., many megabytes) of disk traffic. As a result of 
these conditions, creating a clone of a file system takes 
a significant amount of time to complete. 
[001 9] Another disadvantage of the prior art system 
is that it makes it difficult to create multiple clones of the 

40 same file system. The result of this is that clones tend to 
be used, one at a time, for short term operations such 
as backing up the file system to tape, and are then 
deleted. 

[0020] The present invention, which is defined in 
45 the appended claims, provides a method for maintaining 
a file system in a consistent state and for creating read- 
only copies of a fOe system. Changes to the fOe system 
are tightly controlled to maintain the file system in a con- 
sistent state. The file system progresses from one self- 
so consistent state to another self-consistent state. The set 
of self-consistent blocks on disk that is rooted by the 
root inode is referred to as a consistency point (CP). To 
implement consistency points, WAFL always writes new 
data to unallocated blocks on disk. If never overwrites 
55 existing data. A new consistency point occurs when the 
fsinfo block is updated by writing a new root inode for 
the inode file into it Thus, as long as the root inode is 
not updated, the state of the file system represented on 
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disk does not change. 

[0021] The present invention also creates snap- 
shots, which are virtual read-only copies of the file sys- 
tem. A snapshot uses no disk space when it is initially 
created. It is designed so that many different snapshots s 
can be created for the same file system. Unlike prior art 
file systems that cr eate a clone by duplicating the entire 
inode file and all of the indirect blocks, the present 
invention duplicates only the inode that describes the 
inode file. Thus, the actual disk space required for a 10 
snapshot is only the 128 bytes used to store the dupli- 
cated mode. The 128 bytes of the present invention 
required for a snapshot is significantly less than the 
many megabytes used for a clone in the prior art 
[0022] The present invention prevents new data 15 
written to the active file system from overwriting -old" 
data that is part of a snapshot(s). It is necessary that old 
data not be overwritten as long as it is part of a snap- 
shot This is accomplished by using a multi-bit free- 
block map. Most prior art file systems use a free block 20 
map having a single bit per block to indicate whether or 
not a block is allocated. The present invention uses a 
block map having 32-bit entries. A first bit indicates 
whether a block is used by the active file system, and 20 
remaining bits are used for up to 20 snapshots, how- 25 
ever, some bits of the 31 bits may be used for other pur- 
poses. 

[0023] The present invention will be described 
below with reference to the following description of 
exemplary embodiments and the accompanying draw- so 
ings, in which: 

Figure 1 is a block diagram of a prior art "clone" of 
a file system. 

35 

Figure 2 is a diagram illustrating a list of inodes hav- 
ing dirty buffers. 

Figure 3 is a diagram illustrating an on-disk inode of 
WAFL 40 

Figures 4A-4D are diagrams illustrating on-disk 
inodes of WAFL having different levels of indirec- 
tion. 



Figure 5 is a flow diagram illustrating the method for 
generating a consistency point 

Figure 6 is a flow diagram illustrating step 530 of 
Figure 5 for generating a consistency point. 

Figure 7 is a flow diagram illustrating step 530 of 
Figure 5 for creating a snapshot 

Figure 8 is a diagram illustrating an incore inode of 
WAFL according to the present invention. 

Figures 9A-9D are diagrams illustrating incore 



inodes of WAFL having different levels of indirection 
according to the present invention. 

Figure 10 is a diagram illustrating an incore inode 
1020 for a file. 

Figures 11A-11D are diagrams illustrating a block 
map (blkmap) file according to the present inven- 
tion. 

Figure 12 is a diagram illustrating an inode file 
according to the present invention. 

Figures 13A-13B are diagrams illustrating an inode 
map (inomap) file according to the present inven- 
tion. 

Figure 14 is a diagram illustrating a directory 
according to the present invention. 

Figure 15 is a diagram illustrating a file system 
information (fsinfo) structure. 

Figure 16 is a diagram illustrating the WAFL file 
system. 

Figures 17A-17L are diagrams illustrating the gen- 
eration of a consistency point. 

Figures 18A-18C are diagrams illustrating genera- 
tion of a snapshot. 

Figure 19 is a diagram illustrating changes to an 
inode file. 

Figure 20 is a diagram illustrating fsinfo blocks used 
for maintaining a file system in a consistent state. 

Figures 21A-21F are detailed diagrams illustrating 
generations of a snapshot. 

Figure 22 is a diagram illustrating an active WAFL 
file system having three snapshots that each refer- 
ence a common file; and, 

Figures 23A-23B are diagrams illustrating the 
updating of atime. 



[0024] A system for creating read-only copies of a 
so file system is described. In the following description, 
numerous specific details, such as number and nature 
of disks, disk block sizes, etc., are described in detail in 
order to provide a more thorough description of the 
present invention. It will be apparent, however, to one 
ss skilled in the art, that the present invention may be prac- 
ticed without these specific details. In other instances, 
well-known features have not been described in detail 
so as not to unnecessarily obscure the present inven- 
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tion. 

WRITE ANYWHERE FILE-SYSTEM LAYOUT 

[0025] The present invention uses a Write Any- 
where File-system Layout (WAFL). This disk format sys- 
tem is block based (i.e., 4 KB blocks that have no 
fragments), uses inodes to describe its files, and 
includes directories that are simply specially formatted 
files. WAFL uses files to store meta-data that describes 
the layout of the file system. WAFL meta-data files 
include: an inode file, a block map (blkmap) file, and an 
inode map (inomap) file. The inode ffle contains the 
inode table for the file system. The blkmap ffle indicates 
which disk blocks are allocated. The inomap file indi- 
cates which inodes are allocated. On-disk and incore 
WAFL inode distinctions are discussed below. 

On-Disk WAFL Inodes 

[0026] WAFL inodes are distinct from prior art 
modes. Each on-disk WAFL inode points to 16 blocks 
having the same level of indirection. A block number is 
4-bytes long. Use of block numbers having the same 
level of indirection in an inode better facilitates recursive 
processing of a file. Figure 3 is a block diagram illustrat- 
ing an on-disk inode 310. The on-disk inode 310 is com- 
prised of standard inode information 31 OA and 16 block 
number entries 31 0B having the same level of indirec- 
tion. The inode information 31 OA comprises information 
about the owner of a file, permissions, file size, access 
time, etc. that are well-known to a person skilled in the 
art. On-disk inode 310 is unlike prior art inodes that 
comprise a plurality of block numbers having different 
levels of indirection. Keeping all block number entries 
310B in an inode 310 at the same level of indirection 
simplifies file system implementation. 
[0027] For a small file having a size of 64 bytes or 
less, data is stored directly in the inode itself instead of 
the 1 6 block numbers. Figure 4A is a diagram illustrating 
a Level 0 inode 41 0 that is similar to inode 31 0 shown in 
Figure 3. However, inode 410 comprises 64-bytes of 
data 410B instead of 16 block numbers 310B. There- 
fore, disk blocks do not need to be allocated for very 
small files. 

[0028] For a file having a size of less than 64 KB, 
each of the 16 block numbers directly references a 4 KB 
data block Figure 4B is a diagram illustrating a Level 1 
inode 310 comprising 16 block numbers 310B. The 
block number entries 0-15 point to corresponding 4 KB 
data blocks 420A-420C. 

[0029] For a file having a size that is greater than or 
equal to 64 KB and is less than 64 MB, each of the 16 
block numbers references a single-indirect block. In 
turn, each 4 KB single-indirect block comprises 1024 
block numbers that reference 4 KB data blocks. Figure 
4C is a diagram illustrating a Level 2 inode 310 compris- 
ing 16 block numbers 31 0B that reference 16 single- 



indirect blocks 430A-430C. As shown in Figure 4C, 
block number entry 0 points to single-indirect block 
430 A. Single-indirect block 430 A comprises 1024 block 
numbers that reference 4 KB data blocks 440A-440C. 

5 Similarly, single-indirect blocks 430B-430C can each 
address up to 1024 data blocks. 
[0030] For a file size greater than 64 MB, the 16 
block numbers of the inode reference double-indirect 
blocks. Each 4 KB double-indirect block comprises 

10 1024 block numbers pointing to corresponding single- 
indirect blocks. In turn, each single-indirect block com- 
prises 1024 block numbers that point to 4KB data 
blocks. Thus, up to 64 GB can be addressed. Figure 4D 
is a diagram illustrating a Level 3 inode 310 comprising 

15 16 block numbers 310B wherein block number entries 
0, 1, and 15 reference double-indirect blocks 470 A, 
470B, and 470C, respectively. Double-indirect block 
470A comprises 1024 block number entries 0-1023 that 
point to 1024 single-indirect blocks 430A-480B. Each 

20 single-indirect block 480A-480B, in turn, references 
1024 data blocks. As shown in Figure 4D, single-indirect 
block 480A references 1024 data blocks 490A-430C 
and single-indirect block 480B references 1024 data 
blocks 490C-490F. 

25 

Incore WAFL Inodes 

[0031] Figure 8 is a block diagram illustrating an 
incore WAFL inode 820. The incore inode 820 com- 
30 prises the information of on-disk inode 310 (shown in 
Figure 3), a WAFL buffer data structure 820 A, and 16 
buffer pointers 820B. A WAFL incore inode has a size of 
300 bytes. A WAFL buffer is an incore (in memory) 4 KB 
equivalent of the 4 KB blocks that are stored on disk. 
35 Incore inode 820 is unlike prior art inodes that reference 
buffers having different levels of indirection. Each incore 
WAFL inode 820 points to 16 buffers having the same 
level of indirection. A buffer pointer is 4-bytes long. 
Keeping all buffer pointers 820B in an inode 820 at the 
40 same level of indirection simplifies file system imple- 
mentation. Incore inode 820 also contains incore infor- 
mation 820C comprising a dirty flag, an in-consistency 
point (IN_CP) flag, and pointers for a linked list The 
dirty flag indicates that the inode itself has been modi- 
45 f ied or that if references buffers that have changed. The 
IN_CP flag is used to mark an inode as being in a con- 
sistency point (described below). The pointers for a 
linked list are described below. 
[0032] Figure 1 0 is a diagram illustrating a file refer- 
so enced by a WAFL inode 1010. The file comprises indi- 
rect WAFL buffers 1020-1024 and direct WAFL buffers 
1030-1034. The WAFL in-core inode 1010 comprises 
standard inode information 1010A (including a count of 
dirty buffers), a WAFL buffer data structure 1010B. 16 
55 buffer pointers 1010C and a standard on-disk inode 
1010D. The in-core WAFL inode 1010 has a size of 
approximately 300 bytes. The on-disk inode is 128 
bytes in size. The WAFL buffer data structure 101 0B 
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comprises two pointers where the first one references 
the 1 6 buffer pointers 1 01 OC and the second references 
the on-disk block numbers 1010D. 



[0033] Each inode 1010 has a count of dirty buffers 
that it references. An inode 1010 can be put in the list of 
dirty inodes and/or the list of inodes that have dirty buff- 
ers. When all dirty buffers referenced by an inode are 
either scheduled to be written to disk or are written to 
disk, the count of dirty buffers to inode 1010 is set to 
zero. The inode 1010 is then requeued according to its 
flag (i.e.. no dirty buffers). This inode 1010 is cleared 
before the next inode is processed. Further the flag of 
the inode indicating that it is in a consistency point is 
cleared. The inode 1 010 itself is written to disk in a con- 
sistency point. 

[0034] The WAFL buffer structure is illustrated by 
indirect WAFL buffer 1020. WAFL buffer 1020 com- 
prises a WAFL buffer data structure 1020A, a 4 KB 
buffer 1020B comprising 1024 WAFL buffer pointers 
and a 4 KB buffer 1020C comprising 1024 on-disk block 
numbers. The WAFL buffer data structure is 56 bytes in 
size and comprises 2 pointers. One pointer of WAFL 
buffer data structure 1020A references 4 KB buffer 
1 020B and a second pointer references buffer 1 020C. In 
Figure 10, the 16 buffer pointers 1010C of WAFL inode 
1010 point to the 16 single-indirect WAFL buffers 1020- 
1024. In turn, WAFL buffer 1020 references 1024 direct 
WAFL buffer structures 1030-1034. WAFL buffer 1030 
is representative direct WAFL buffers. 
[0035] Direct WAFL buffer 1030 comprises WAFL 
buffer data structure 1030 A and a 4 KB direct buffer 
1030B containing a cached version of a corresponding 
on-disk 4 KB data block. Direct WAFL buffer 1030 does 
not comprise a 4 KB buffer such as buffer 1 020C of indi- 
rect WAFL buffer 1020. The second buffer pointer of 
WAFL buffer data structure 1030A is zeroed, and there- 
fore does not point to a second 4 KB buffer. This pre- 
vents inefficient use of memory because memory space 
would be assigned for an unused buffer otherwise. 
[0036] In the WAFL file system as shown in Figure 
10, a WAFL in-core inode structure 1010 references a 
tree of WAFL buffer structures 1020-1024 and 1030- 
1034. It is similar to a tree of blocks on disk referenced 
by standard inodes comprising block numbers that 
pointing to indirect and/or direct blocks. Thus, WAFL 
inode 1010 contains not only the on-disk inode 1010D 
comprising 16 volume block numbers, but also com- 
prises 16 buffer pointers 1010C pointing to WAFL buffer 
structures 1020-1024 and 1030-1034. WAFL buffers 
1030-1034 contain cached contents of blocks refer- 
enced by volume block numbers. 
[0037] The WAFL in-code inode 1010 contains 16 
buffer pointers 1010C. In turn, the 16 buffer pointers 
1010C are referenced by a WAFL buffer structure 
1010B that roots the tree of WAFL buffers 1020-1024 
and 1030-1034. Thus, each WAFL inode 1010 contains 
a WAFL buffer structure 101 0B that points to the 16 
buffer pointers 1010C in the inode 1010. This facilitates 



' ' algorithms for handling trees of buffers that are imple- 
mented recursively. If the 16 buffer pointers 1010C in 
the inode 1010 were not represented by a WAFL buffer 
structure 101 0B, the recursive algorithms for operating 
5 on an entire tree of buffers 1020-1024 and 1030-1034 
would be difficult to implement. 
[0038] Figures 9A-9D are diagrams illustrating 
inodes having different levels of indirection. In Figures 
9A-9D, simplified indirect and direct WAFL buffers are 
w illustrated to show indirection. However, it should be 
understood that the WAFL buffers of Figure 9 represent 
corresponding indirect and direct buffers of Figure 10. 
For a small file having a size of 64 bytes or less, data is 
stored directly in the inode itself instead of the 16 buffer 
is pointers. Figure 9A is a diagram illustrating a Level 0 
inode 820 that is the same as inode 820 shown in Fig- 
ure 8 except that inode 820 comprises 64-bytes of data 
920B instead of 16 buffer pointers 820B. Therefore, 
additional buffers are not allocated for very small files. 
20 [0039] For a file having a size of less than 64 KB, 
each of the 1 6 buffer pointers directly references a 4 KB 
direct WAFL buffer. Figure 9B is a diagram illustrating a 
Level 1 inode 820 comprising 16 buffer pointers 820B. 
The buffer pointers PTR0-PTR15 point to correspond- 
25 ing 4 KB direct WAFL buffers 922A-922C. 

[0040] For a file having a size that is greater than or 
equal to 64 KB and is less than 64 MB, each of the 16 
buffer pointers references a single-indirect WAFL buffer. 
In turn, each 4 KB single-indirect WAFL buffer com- 
30 prises 1024 buffer pointers that reference 4 KB direct 
WAFL buffers. Figure 9C is a diagram illustrating a Level 
2 inode 820 comprising 1 6 buffer pointers 820B that ref- 
erence 16 single-indirect WAFL buffers 930A-930C. As 
shown in Figure 9C, buffer pointer PTR0 points to sin- 
35 gle-indirect WAFL buffer 930A. Single-indirect WAFL 
buffer 930A comprises 1024 pointers that reference 4 
KB direct WAFL buffers 940A-940C. Similarly, single- 
indirect WAFL buffers 930B-930C can each address up 
to 1024 direct WAFL buffers. 
40 [0041] For a file size greater than 64 MB, the 16 
buffer pointers of the inode reference doiWe-indirect 
WAFL buffers. Each 4 KB double-indirect WAFL buffer 
comprises 1024 pointers pointing to corresponding sin- 
gle-indirect WAFL buffers. In turn, each single-indirect 
45 WAFL buffer comprises 1024 pointers that point to 4KB 
direct WAFL buffers. Thus, up to 64 GB can be 
addressed. Figure 9D is a diagram illustrating a Level 3 
inode 820 comprising 16 pointers 820B wherein point- 
ers PTR0, PTR1, and PTR15 reference doiWe-indirect 
so WAFL buffers 970A.970B, and 970C, respectively. Dou- 
ble-indirect WAFL buffer 970A comprises 1024 pointers 
that point to 1024 single-indirect WAFL buffers 980A- 
980B. Each single-indirect WAFL buffer 980A-980B, in 
turn, references 1024 direct WAFL buffers. As shown in 
55 Figure 9D, single-indirect WAFL buffer 980A references 
1024 direct WAFL buffers 990A-990C and single-indi- 
rect WAFL buffer 980B references 1024 direct WAFL 
buffers 990D-990F. 
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Directories 

[0042] Directories in the WAFL system are stored in 
4 KB blocks that are divided into two sections. Figure 14 
is a diagram illustrating a directory block 1410 accord- s 
ing to the present invention. Each directory block 1410 
comprises a first section 1410A comprising fixed length 
directory entry structures 1412-1414 and a second sec- 
tion 1410B containing the actual directory names 1416- 
1418. Each directory entry also contains a file id and a 
generation. This information identifies what file the entry 
references. This information is well-known in the art 
and therefore is not illustrated in Figure 14. Each entry 
1412-1414 in the first section 141 OA of the directory 
block has a pointer to its name in the second section 
141 OB. Further, each entry 1412-1414 includes a hash 
value dependent upon its name in the second section 
141 OB so that the name is examined only when a hash 
hit (a hash match) occurs. For example, entry 1412 of 
the first section 141 OA comprises a hash value 1412A 
and a pointer 1412B. The hash value 1412A is a value 
dependent upon the directory name 
"DIRECTORY_ABC" stored in variable length entry 
1416 of the second section 141 OB. Pointer 1412B of 
entry 1410 points to the variable length entry 1416 of 
second section 141 OB. Using fixed length directory 
entries 1412-1414 in the first section 141 OA speeds up 
the process of name lockup. A calculation is not 
required to find the next entry in a directory block 1 41 0. 
Further, keeping entries 1412-1414 in the first section 
small 1 41 OA improves the hit rate for file systems with a 
line-fill data cache. 

Meta-Data 

[0043] WAFL keeps information that describes a file 
system in files known as m eta-data. Meta-data com- 
prises an inode file, inomap file, and a blkmap file. 
WAFL stores its metadata in files that may be written 
anywhere on a disk Because all WAFL meta-data is 
kept in files, it can be written to any location just like any 
other file in the file system. 

[0044] An first meta-data file is the Inode file" that 
contains inodes describing all other files in the file sys- 
tem. Figure 12 is a diagram illustrating an inode file 
1210. The inode file 1210 may be written anywhere on 
a disk unlike prior art systems that write "inode tables" 
to a fixed location on disk. The inode file 1210 contains 
an inode 1210A-1210F for each ffle in the file system 
except for the inode file 1210 itself. The inode file 1210 
is pointed to by an inode referred to as the "root inode". 
The root inode is kept in a fixed location on disk referred 
to as the file system information (fsinfo) block described 
below. The inode file 1210 itself is stored in 4 KB blocks 
on disk (or 4 KB buffers in memory). Figure 12 illus- 
trates that inodes 1210A-1210C are stored in a 4 KB 
buffer 1220. For on-disk inode sizes of 128 bytes, a 4 
KB buffer (or block) comprises 32 inodes. The incore 



inode file 1210 is composed of WAFL buffers 1220. 
When an incore inode (i.e., 121 OA) is loaded, the on- 
disk inode part of the incore inode 1 21 OA is copied in for 
the buffer 1220 of the inode file 1210. The buffer data 
itself is loaded from disk Writing data to disk is done in 
the reverse order. The incore inode 121 OA, which is a 
copy of the ondisk inode, is copied to the corresponding 
buffer 1220 of the inode file 1210. Then, the inode file 
1 210 is write-allocated, and the data stored in the buffer 
1220 of the inode file 1210 is written to disk. 
[0045] Another meta-data file is the "block map" 
(blkmap) file. Figure 1 1 A is a diagram illustrating a blk- 
map file 1110. The blkmap file 1110 contains a 32-bit 
entry 1 1 1 0 A-1 1 1 0C for each 4 KB block in the disk sys- 
tem. It also serves as a free-block map file. The blkmap 
file 1110 indicates whether or not a disk block has been 
allocated. Figure 11B is a diagram of a block entry 
1110A of blkmap ffle 1110 (shown in Figure 11 A). As 
shown in Figure 11B, entry 1110A is comprised of 32 
bits (BIT0-BIT31). Bit 0 (BITO) of entry 1110A is the 
active file system bit (FS-BIT). The FS-bit of entry 
1 1 10A indicates whether or not the corresponding block 
is part of the active file system. Bits 1-20 (BIT1-BIT20) 
of entry 1 1 1 0A are bits that indicate whether the block is 
part of a corresponding snapshot 1-20. The next upper 
1 0 bits (BIT21 -BIT30) are reserved. Bit 31 (BIT31) is the 
consistency point bit (CP-BIT) of entry 1 1 10A. 
[0046] A block is available as a free block in the file 
system when all bits (BIT0-BIT31) in the 32-bit entry 
1 1 1 0A for the block are clear (reset to a value of 0). Fig- 
ure 1 1C is a diagram illustrating entry 1 1 10A of Figure 
1 1 A indicating the disk block is free. Thus, the block ref- 
erenced by entry 1 1 1 0A of blkmap file 1 1 1 0 is free when 
bits 0-31 (BIT0-BIT31) all have values of 0. Figure 11D 
is a diagram illustrating entry 1 1 10A of Figure 1 1 A indi- 
cating an allocated block in the active file system. When 
bit 0 (BITO), also referred to as the FS-bit, is set to a 
value of 1 , the entry 1 1 10A of blkmap file 1110 indicates 
a block that is part of the active file system. Bits 1-20 
(BIT1-BIT20) are used to indicate corresponding snap- 
shots, if any, that reference the block. Snapshots are 
described in detail below. If bit 0 (BITO) is set to a value 
of 0, this does not necessarily indicate that the block is 
available for allocation. All the snapshot bits must also 
be zero for the block to be allocated. Bit 31 (B1T31) of 
entry 1 1 10A always has the same state as bit 0 (BITO) 
on disk, however, when loaded into memory bit 31 
(BIT31) is used for bookkeeping as part of a consist- 
ency point. 

[0047] Another meta-data file is the Inode map" 
(inomap) file that serves as a free inode map. Figure 
13A is a diagram illustrating an inomap ffle 1310. The 
inomap file 1310 contains an 8-bit entry 1310A-1310C 
for each block in the inode file 1210 shown in Figure 12. 
Each entry 1310A-1310C is a count of allocated inodes 
in the corresponding block of the inode ffle 1210. Figure 
13A shows values of 32,5, and 0 in entries 1310A- 
1310C, respectively. The inode file 1210 must still be 
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inspected to find which inodes in the block are free, but 
does not require large numbers of random blocks to be 
loaded into memory from disk. Since each 4 KB block 
1220 of inode file 1210 holds 32 inodes, the 8-bit 
inomap entry 1310A-1310C for each block of inode file s 
1210 can have values ranging from 0 to 32. When a 
block 1220 of an inode file 1210 has no inodes in use. 
the entry 1310A-1310C for rt in inomap file 1310 is 0. 
When all the inodes in the block 1220 inode file 1210 
are in use, the entry 1310A-1310C of the inomap file 10 
1310 has a value of 32. 

[0048] Figure 13B is a diagram illustrating an 
inomap file 1350 that references the 4 KB blocks 
1340A-1340C of inode file 1340. For example, inode file 
1340 stores 37 inodes in three 4 KB blocks 1340A- rs 
1340C. Blocks 1340A-1340C of inode file 1340 contain 
32, 5, and 0 used modes, respectively. Entries 1350A- 
1350C of blkmap file 1350 reference blocks 1340A- 
1340C of inode file 1340, respectively. Thus, the entries 
1 350A-1 350C of inomap file have values of 32,5, and 0 20 
for blocks 1340A-1340C of inode file 1340. In turn, 
entries 1350A-1350C of inomap file indicate 0, 27, and 
32 free inodes in blocks 1340A-1340C of inode ffle 
1340, respectively. 

[0049] Referring to Figure 1 3, using a bitmap for the 25 
entries 1310A-1310C of inomap file 1310 instead of 
counts is disadvantageous since it would require 4 
bytes per entry 1310A-1310C for block 1220 of the 
inode file 1210 (shown in Figure 12) instead of one byte. 
Free inodes in the Wock(s) 1220 of the inode file 1210 so 
do not need to be indicated in the inomap file 1310 
because the inodes themselves contain that informa- 
tion. 

[0050] Figure 1 5 is a diagram illustrating a file sys- 
tem information (fsinfo) structure 1510. The root inode 35 
151 OB of a file system is kept in a fixed location on disk 
so that it can be located during booting of the file sys- 
tem. The fsinfo block is not a meta-data file but is part of 
the WAFL system. The root inode 1 51 OB is an inode ref- 
erencing the inode f ile 1210. It is part of the f ile system 4C 
information (fsinfo) structure 1510 that also contains 
information 1 51 OA including the number of blocks in the 
file system, the creation time of the file system, etc. The 
miscellaneous information 151 OA further comprises a 
checksum 1 510C (described below). Except for the root 4i 
inode 1 51 OB itself, this information 1 51 OA can be kept in 
a meta-data ffle in an alternate embodiment. Two identi- 
cal copies of the fsinfo structure 1510 are kept in fixed 
locations on disk. 

[0051 ] Figure 1 6 is a diagram illustrating the WAFL s 
f ile system 1670 in a consistent state on disk compris- 
ing two fsinfo blocks 1610 and 1612, inode file 1620, 
blkmap file 1630, inomap file 1640. root directory 1650, 
and a typical file (or directory) 1660. Inode file 1620 is 
comprised of a plurality of inodes 1 620A-1620D that ref- & 
erence other files 1630-1660 in the file system 1670. 
Inode 1620 A of inode file 1620 references blkmap file 
1630. Inode 1620B references inomap file 1640. Inode 
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1620C references root directory 1650. Inode 1620D ref- 
erences a typical file (or directory) 1660. Thus, the 
inode file points to all files 1630-1660 in the file system 
1670 except for fsinfo blocks 1610 and 1612. Fsinfo 
blocks 1610 and 1612 each contain a copy 1610B and 
1612B of the inode of the inode file 1620, respectively. 
Because the root inode 1610B and 1612B of fsinfo 
blocks 1610 and 1612 describes the inode file 1620, 
that in turn describes the rest of the files 1630-1660 in 
the file system 1670 including all meta-data files 1630- 
1 640, the root inode 1 61 OB and 1 61 2B is viewed as the 
root of a tree of blocks. The WAFL system 1670 uses 
this tree structure for its update method (consistency 
point) and for implementing snapshots, both described 
below. 

I ist of Inodes Having Dirtv Blocks 

[0052] WAFLin-core inodes (i.e., WAFL inode 1010 
shown in Figure 10) of the WAFL file system are main- 
tained in different linked lists according to their status. 
Inodes that reference dirty blocks are kept in a dirty 
inode list as shown in Figure 2. Inodes containing valid 
data that is not dirty are kept in a separate list and 
inodes that have no valid data are kept in yet another, as 
is well-known in the art. The present invention utilizes a 
list of inodes having dirty data blocks that facilitates find- 
ing all of the inodes that need write allocations to be 
done. 

[0053] Figure 2 is a diagram illustrating a list 21 0 of 
dirty inodes according to the present invention. The list 
210 of dirty inodes comprises WAFL in-core inodes 
220-1750. As shown in Figure 17, each WAFL in-core 
inode 220-250 comprises a pointer 220A-250A, respec- 
tively, that points to another inode in the linked list For 
example, WAFL inodes 220-250 are stored in memory 
at locations 2048. 2152, 2878. 3448 and 3712, respec- 
tively. Thus, pointer 220A of inode 220 contains address 
2152. It points therefore to WAFL inode 222. In turn, 

i WAFL inode 222 points to WAFL inode 230 using 
address 2878. WAFL inode 230 points to WAFL inode 
240. WAFL inode 240 points to inode 1750. The pointer 
250A of WAFL inode 250 contains a null value and 
therefore does not point to another inode. Thus, it is the 

y last inode in the list 210 of dirty inodes. Each inode in 
the list 210 represents a file comprising a tree of buffers 
as depicted in Figure 10. At least one of the buffers ref- 
erenced by each inode 220-250 is a dirty buffer. A dirty 
buffer contains modified data that must be written to a 

0 new disk location in the WAFL system. WAFL always 
writes dirty buffers to new locations on disk. 

QONfilfiTEN CY POINTS 

5 [0054] The WAFL disk structure described so far is 
static. In the present invention, changes to the file sys- 
tem 1670 are tightly controlled to maintain the file sys- 
tem 1670 in a consistent state. The file system 1670 
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progresses from one self-consistent state to another 
self-consistent state. The set (or tree) of self-consistent 
blocks on disk that is rooted by the root inode 151 OB is 
referred to as a consistency point (CP). To implement 
consistency points, WAFL always writes new data to 
unallocated blocks on disk. It never overwrites existing 
data. Thus, as long as the root inode 1510B is not 
updated, the state of the file system 1670 represented 
on disk does not change. However, for a file system 
1 670 to be useful, it must eventually refer to newly writ- 
ten data, therefore a new consistency point must be 
written. 

[0055] Referring to Figure 16, a new consistency 
point is written by first flushing all fOe system blocks to 
new locations on disk (including the blocks in meta-data 
files such as the inode ffle 1620. blkmap file 1630. and 
inomap file 1640). A new root inode 161 0B and 1612B 
for the file system 1670 is then written to disk. With this 
method for atomically updating a file system, the on- 
disk file system is never inconsistent The on-disk file 
system 1670 reflects an old consistency point up until 
the root inode 161 0B and 1612B is written. Immediately 
after the root inode 161 0B and 1612B is written to disk, 
the file system 1670 reflects a new consistency point 
Data structures of the file system 1670 can be updated 
in any order, and there are no ordering constraints on 
disk writes except the one requirement that all blocks in 
the file system 1670 must be written to disk before the 
root inode 1610B and 1612B is updated. 
[0056] To convert to a new consistency point, the 
root inode 1610B and 1612B must be updated reliably 
and atomically. WAFL does this by keeping two identical 
copies of the fsinfo structure 1610 and 1612 containing 
the root inode 161 0B and 1612B. During updating of the 
root inode 161 0B and 1612B, a first copy of the fsinfo 
structure 1610 is written to disk, and then the second 
copy of the fsinfo structure 1 612 is written. A checksum 
1 61 0C and 1 61 2C in the fsinfo structure 1 61 0 and 1 61 2, 
respectively, is used to detect the occurrence of a sys- 
tem crash that corrupts one of the copies of the fsinfo 
structure 1610 or 1612, each containing a copy of the 
root inode, as it is being written to disk. Normally, the 
two fsinfo structures 1610 and 1612 are identical. 

Algorithm for Generating g Consistency Ppint 

[0057] Figure 5 is a diagram illustrating the method 
of producing a consistency point In step 510, all "dirty" 
i nodes (inodes that point to new blocks containing mod- 
ified data) in the system are marked as being in the con- 
sistency point their contents, and only their contents, 
are written to disk. Only when those writes are complete 
are any writes from other inodes allowed to reach disk. 
Further, during the time dirty writes are occurring, no 
new modifications can be made to inodes that are in the 
consistency point 

[0058] In addition to setting the consistency point 
flag for all dirty inodes that are part of the consistency 



point, a global consistency point flag is set so that user- 
requested changes behave in a tightly controlled man- 
ner. Once the global consistency point flag is set, user- 
requested changes are not allowed to affect inodes that 

5 are in the consistency point. Further, only inodes having 
a consistency point flag that is set are allocated disk 
space for their dirty blocks. Consequently, the state of 
the file system will be flushed to disk exactly as it was 
when the consistency point began. 

w [0059] In step 520, regular files are flushed to disk. 
Rushing regular files comprises the steps of allocating 
disk space for dirty blocks in the regular files, and writ- 
ing the corresponding WAFL buffers to disk. The inodes 
themselves are then flushed (copied) to the inode file. 

is All inodes that need to be written are in either the list of 
inodes having dirty buffers or the list of inodes that are 
dirty but do not have dirty buffers. When step 520 is 
completed, there are no more ordinary inodes in the 
consistency point and ail incoming I/O requests suc- 

20 ceed unless the requests use buffers that are still locked 
up for disk I/O operations. 

[0060] In step 530, special files are flushed to disk. 
Flushing special files comprises the steps of allocating 
disk space for dirty blocks in the two special fBes: the 

25 inode file and the blkmap file, updating the consistency 
bit (CP-bit) to match the active file system bit (FS-bit) for 
each entry in the blkmap file, and then writing the blocks 
to disk. Write allocating the inode ffle and the blkmap is 
complicated because the process of write allocating 

30 them changes the files themselves. Thus, in step 530 
writes are disabled while changing these files to prevent 
important blocks from locking up in disk I/O operations 
before the changes are completed. 
[0061] Also, in step 530, the creation and deletion 

35 of snapshots, described below, are performed because 
it is the only point in time when the file system, except 
for the fsinfo block, is completely self consistent and 
about to be written to disk. A snapshot is deleted from 
the file system before a new one is created so that the 

40 same snapshot inode can be used in one pass. 

[0062] Figure 6 is a flow diagram illustrating the 
steps that step 530 comprises. Step 530 allocates disk 
space for the blkmap ffle and the inode file and copies 
the active FS-bit into the CP-bit for each entry in the blk- 

45 map f ila In step 61 0, the inode for the blkmap file is pre- 
f lushed to the inode file. This ensures that the block in 
the inode file that contains the inode of the blkmap file is 
dirty so that step 620 allocates disk space for it 
[0063] In step 620, disk space is allocated for all 

50 dirty blocks in the inode and blkmap files. The dirty 
blocks include the block in the inode ffle containing the 
inode of the blkmap ffle is dirty. 
[0064] In step 630, the inode for the blkmap file is 
flushed again, however this time the actual inode is writ- 

55 ten to the pre-flushed block in the inode file. Step 610 
has already dirtied the block of the inode file that con- 
tains the inode of the blkmap file. Thus, another write- 
allocate, as in step 620, does not need to be scheduled. 
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[0065] In step 640, the entries for each block in the 
Wkmap file are updated. Each entry is updated by copy- 
ing the active FS-bit to the CP-bit (i.e., copying bit 0 into 
bit 31) for all entries in dirty blocks in the Wkmap file. 
[0066] In step 650. all dirty blocks in the Wkmap and 
inode files are written to disk. 
[0067] Only entries in dirty Wocks of the blkmap file 
need to have the active file system Wt (FS-bit) copied to 
the consistency point bit (CP-bit) in step 640. Immedi- 
ately after a consistency point, all Wkmap entries have 
same value for both the active FS-bit and CP-Kt As time 
progresses, some active FS-bits of Wkmap file entries 
for the file system are either cleared or set. The Wocks 
of the blkmap file containing the changed FS-Wts are 
accordingly marked dirty. During the following consist- 
ency point. Wocks that are clean do not need to be re- 
copied. The clean blocks are not copied because they 
were not dirty at the previous consistent point and noth- 
ing in the Wocks has changed since then. Thus, as long 
as the file system is initially created with the active FS- 
bit and the CP-Wt having the same value in all blkmap 
entries, only entries with dirty blocks need to be 
updated at each consistency point 
[0068] Referring to Figure 5, in step 540, the file 
system information (fsinfo) Wock updated and then 
flushed to disk. The fsinfo block is updated by writing a 
new root inode for the inode file into it The fsinfo Wock 
is written twice. It is f irst written to one location and then 
to a second location. The two writes are performed so 
that when a system crash occurs during either write, a 
self-consistent file system exists on disk. Therefore, 
either the new consistency point is available if the sys- 
tem crashed while writing the second fsinfo Wock or the 
previous consistency point (on disk before the recent 
consistency point began) is available if the first fsinfo 
Wock failed. When the file system is restarted after a 
system failure, the highest generation count for a con- 
sistency point in the fsinfo Wocks having a correct 
checksum value is used. This is described in detail 

below. . . 

[0069] In step 550, the consistency point is com- 
pleted. This requires that any dirty inodes that were 
delayed because they were not part of the consistency 
point be requeued. Any inodes that had their state 
change during the consistency point are in the consist- 
ency point waft (CP.WAIT) queue. The CP_WAIT 
queue holds inodes that changed before step 540 com- 
pleted, but after step 510 when the consistency point 
started. Once the consistency point is completed, the 
inodes in the CP_WAIT queue are re-queued accord- 
ingly in the regular list of inodes with dirty buffers and list 
of dirty inodes without dirty buffers. 

Ring ia nrriftrinq Constrain* of Consistency Point 

[0070] The present invention, as illustrated in Fig- 
ures 20A-20C, has a single ordering constraint. The sin- 
gle ordering constraint is that the fsinfo Wock 1810 is 



written to disk only after all the other Wocks are written 
to disk. The writing of the fsinfo Wock 1810 is atomic, 
otherwise the entire file system 1 830 could be lost Thus, 
the WAFL file system requires the fsinfo Wock 1810 to 
s be written at once and not be in an inconsistent state. 
As illustrated in Figure 15. each of the fsinfo Wocks 
1810 (1510) contains a checksum 1510C and a gener- 
ation count 1510D. 

[0071] Figure 20A illustrates the updating of the 
io generation count 1810D and 1870D of fsinfo Wocks 
1810and 1870. Each time a consistency point (or snap- 
shot) is performed, the generation count of the fsinfo 
Wock is updated. Figure 20A illustrates two fsinfo Wocks 
1810 and 1870 having generation counts 1810D and 
is 1870D, respectively, that have the same value of N indi- 
cating a consistency point for the f ile system. Both fsirrfo 
Wocks reference the previous consistency point (old file 
system on disk) 1830. A new version of the f ile system 
exists on disk and is referred to as new consistency 
20 point 1 831 . The generation count is incremented every 
consistency point. 

[0072] In Figure 20B, the generation count 1810D 
of the first fsinfo Wock 1810 is updated and given a 
value of N+1 . It is then written to disk. Figure 20B illus- 
25 trates a value of N+1 for generation count 1810D of 
fsinfo Wock 1810 whereas the generation count 1870D 
of the second fsinfo Wock 1870 has a value of N. Fsinfo 
Wock 1810 references new consistency point 1831 
whereas fsinfo Wock 1870 references old consistency 
30 point 1830. Next, the generation count 1870D of fsinfo 
Wock 1870 is updated and written to disk as illustrated 
in Figure 20C. In Figure 20C. the generation count 
1870D of fsinfo Wock 1870 has a value of N+1. There- 
fore the two fsinfo blocks 1810 and 1870 have the same 
35 generation count value of N+1 . 

[0073] When a system crash occurs between fsinfo 
Wock updates, each copy of the fsinfo Wock 1810 and 
1 870 will have a self consistent checksum (not shown in 
the diagram), but one of the generation numbers 1810D 
40 or 1870D will have a higher value. A system wash 
occurs when the f ile system is in the state illustrated in 
Figure 20B. For example, in the preferred embodiment 
of the present invention as illustrated in Figure 20B, the 
generation count 1810D of fsinfo Wock 1810 is updated 
45 before the secondfsinfo Wock 1870. Therefore, the gen- 
eration count 1810D (value of one) is greater than the 
generation count 1870D of fsinfo Wock 1870. Because 
the generation count of the first fsinfo Wock 1810 is 
higher, it is selected for recovering the file system after 
so a system crash. This is done because the first fsinfo 
Wock 1810 contains more current data as indicated by 
its generation count 1810D. For the case when the first 
fsinfo Wock is corrupted because the system crashes 
while it is being updated, the other copy 1870 of the 
55 fsinfo Wock is used to recover the file system 1830 into 
a consistent state. 

[0074] It is not possiWe for both fsinfo Wocks 181 0 
and 1 870 to be updated at the same time in the present 
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invention. Therefore, at least one good copy of the fsinfo 
block 1810 and 1870 exists in the file system. This 
allows the file system to alsways be recovered into a 
consistent state. 

[0075] WAFL does not require special recovery pro- 
cedures. This is unlike prior art systems that use log- 
ging, ordered writes, and mostly ordered writes with 
recovery. This is because only data corruption, which 
RAID protects against, or software can corrupt a WAFL 
file system. To avoid losing data when the system fails, 
WAFL may keep a non-volatile transaction log of all 
operations that have occurred since the most recent 
consistency point This log is completely independent of 
the WAFL disk format and is required only to prevent 
operations from being lost during a system crash. How- 
ever, it is not required to maintain consistency of the file 
system. 

Generating A Consistency Point 

[0076] As described above, changes to the WAFL 
file system are tightly controlled to maintain the file sys- 
tem in a consistent state. Figures 1 7A-1 7H illustrate the 
generation of a consistency point for a WAFL file sys- 
tem. The generation of a consistency point is described 
with reference to Figures 5 and 6. 
[0077] In Figures 17A-17L, buffers that have not 
been modified do not have asterisks beside them. 
Therefore, buffers contain the same data as corre- 
sponding on-disk blocks. Thus, a block may be loaded 
into memory but it has not changed with respect to its 
on disk version. A buffer with a single asterisk (*) beside 
it indicates a dirty buffer in memory (its data is modi- 
fied). A buffer with a double asterisk (**) beside it indi- 
cates a dirty buffer that has been allocated disk spaca 
Finally, a buffer with a triple asterisk (***) is a dirty buffer 
that is written into a new block on disk. This convention 
for denoting the state of buffers is also used with respect 
to Figures 2 1A-21E. 

[0078] Figure 17A illustrates a list 2390 of inodes 
with dirty buffers comprising inodes 2306A and 2306B. 
Inodes 2306A and 2306B reference frees of buffers 
where at least one buffer of each tree has been modi- 
fied. Initially, the consistency point flags 2391 and 2392 
of inodes 2306A and 2306B are cleared (0). While a list 
2390 of inodes with dirty buffers is illustrated for the 
present system, it should be obvious to a person skilled 
in the art that other lists of inodes may exist in memory. 
For instance, a list of inodes that are dirty but do not 
have dirty buffers is maintained in memory. These 
inodes must also be marked as being in the consistency 
point. They must be flushed to disk also to write the dirty 
contents of the inode file to disk even though the dirty 
inodes do not reference dirty blocks. This is done in step 
520 of Figure 5. 

[0079] Figure 17B is a diagram illustrating a WAFL 
file system of a previous consistency point comprising 
fsirrfo block 2302, inode f Qe 2346, blkmap ffle 2344 and 



files 2340 and 2342. File 2340 comprises blocks 2310- 
2314 containing data "A", "B", and "C\ respectively. File 
2342 comprises data blocks 2316-2320 comprising 
data "D", "E", and "P, respectively. Blkmap file 2344 

5 comprises block 2324. The inode file 2346 comprises 
two 4KB blocks 2304 and 2306. The second block 2306 
comprises inodes 2306A-2306C that reference file 
2340, ffle 2342, and blkmap file 2344, respectively. This 
is illustrated in block 2306 by listing the file number in 

10 the inode. Fsinfo block 2302 comprises the root inode. 
The root inode references blocks 2304 and 2306 of 
inode file 2346. Thus, Figure 17B illustrates a tree of 
buffers in a file system rooted by the fsinfo block 2302 
containing the root inode. 

is [0080] Figure 1 7C is a diagram illustrating two mod- 
ified buffers for blocks 2314 and 2322 in memory. The 
active file system is modified so that the block 231 4 con- 
taining data "C" is deleted from file 2340. Also, the data 
"P stored in block 2320 is modified to "F-prime", and is 

20 stored in a buffer for disk block 2322. It should be under- 
stood that the modified data contained in buffers for disk 
blocks 2314 and 2322 exists only in memory at this 
time. All other blocks in the active file system in Figure 
17C are not modified, and therefore have no asterisks 

25 beside them. However, some or all of these blocks may 
have corresponding dean buffers in memory. 
[0081] Figure 17D is a diagram illustrating the 
entries 2324A-2324M of the blkmap file 2344 in mem- 
ory. Entries 2324A-2324M are contained in a buffer for 4 

30 KB block 2324 of blkmap file 2344. As described previ- 
ously, BIT0 and BIT31 are the FS-BIT and CP-BIT. 
respectively. The consistency point bit (CP-BIT) is set 
during a consistency point to ensure that the corre- 
sponding block is not modified once a consistency point 

35 has begun, but not finished, BIT1 is the first snapshot bit 
(described below). Blkmap entries 2324A and 2324B 
illustrate that, as shown in Figure 17B, the 4 KB blocks 
2304 and 2306 of inode file 2346 are in the active file 
system (FS-BIT equal to 1) and in the consistency point 

40 (CP-BIT equal to 1). Similarly, the other blocks 2310- 
231 2 and 231 6-2320 and 2324 are in the active file sys- 
tem and in the consistency point However, blocks 2308, 
2322, and 2326-2328 are neither in the active fOe sys- 
tem nor in the consistency point (as indicated by BIT0 

45 and BIT31, respectively). The entry for deleted block 
231 4 has a value of 0 in the FS-BIT indicating that it has 
been removed from the active file system 
[0082] In step 510 of Figure 5, all "dirty" inodes in 
the system are marked as being in the consistency 

so point Dirty inodes include both inodes that are dirty and 
inodes that reference dirty buffers. Figure 171 illustrates 
a list of inodes with dirty buffers where the consistency 
point flags 2391 and 2392 of inodes 2306A and 2306B 
are set (1). Inode 2306A references block 2314 contain- 

55 ing data "C" of file 2340 which is to be deleted from the 
active fOe system. Inode 2306B of block 2306 of inode 
ffle 2346 references file 2342. Block 2320 containing 
data "P has been modified and a new block containing 
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data "F" must be allocated. In step 510. the dirty inodes 
2306A and 2306B are copied into the buffer for block 
2308. The buffer for block 2306 is subsequently written 
to disk (in step 530). This is illustrated in Figure 17E. 
The modified data exists in memory only, and the buffer 
2308 is marked dirty. The inconsistency point flags 2391 
and 2392 of inodes 2306A and 2306B are then cleared 
(0) as illustrated in Figure 1 7A. This releases the inodes 
for use by other processes. 

10083] In step 520, regular files are flushed to disk. 
Thus, block 2322 is allocated disk space. Block 2314 of 
file 2340 is to be deleted, therefore nothing occurs to 
this block until the consistency point is subsequently 
completed. Block 2322 is written to disk in step 520. 
This is illustrated in Figure 1 7F where buffers for blocks 
2322 and 2314 have been written to disk (marked by 
*") The intermediate allocation of disk space (**) is not 
shown. The inodes 2308A and 2308B of block 2308 of 
inode file 2346 are flushed to the inode file. Inode 
2308A of block 2308 references blocks 2310 and 2312 
of file 2346. Inode 2308B references blocks 231 6. 231 8, 
2322 for file 2342. As illustrated in Figure 17F. disk 
space is allocated for block 2308 of inode 2346 and for 
direct block 2322 for file 2342. However, the file system 
itself has not been updated. Thus, the file system 
remains in a consistent state. 
[0084] In step 530, the Wkmap file 2344 is flushed 
to disk. This is illustrated in Figure 17G where the Wk- 
map f ile 2344 is indicated as being dirty by the asterisk. 
[00851 m step 610 of Figure 6. the inode for the Wk- 
map file is pre-flushed to the inode file as illustrated in 
Figure 17H. Inode 2308C has been flushed to block 
230B of inode file 2346. However, inode 2308C still ref- 
erences Wock 2324. In step 620, disk space is allocated 
for Wkmap file 2344 and inode file 2346. Block 2308 is 
allocated for inode f ile 2346 and Wock 2326 is allocated 
for Wkmap f Oe 2344. As described above. Wock 2308 of 
inode file 2346 contains a pre-flushed inode 2308C for 
Wkmap file 2344. In step 630. the inode for the Wkmap 
file 2344 is written to the pre-flushed Wock 2308C in 
inode 2346. Thus, inoore inode 2308C is updated to ref- 
erence Wock 2324 in step 620. and is copied into the 
buffer in memory containing Wock 2306 that is to be 
written to Wock 2308. This is illustrated in Figure 17H 
where inode 2308C references block 2326. 
[0086] In step 640. the entries 2326A-2326L for 
each Wock 2304-2326 in the Wkmap file 2344 are 
updated in Figure 17J. Blocks that have not changed 
since the consistency point began in Figure 17B have 
the same values in their entries. The entries are 
updated by copying BIT0 (FS-bit) to the consistency 
point Wt (BIT31). Block 2306 is not part of the active file 
system, therefore BIT0 is equal to zero (BIT0 was 
turned off in step 620 when Wock 2308 was allocated to 
hold the new data for that part of the inode f ile). This is 
illustrated in Figure 17J for entry 2326B. Similarly, entry 
2326F for Wock 2314 of file 2340 has BIT0 and BIT31 
equal to zero. Block 2320 of file 2342 and Wock 2324 of 



' ' Wkmap' file 2344 are handled similarly as shown in 
entries 2361 and 2326K. respectively. In step ^650. dirty 
Wock2308 of inodefile2346 and dirty Wock 2326 of Wk- 
map file 2344 are written to disk. This is indicated in Fig- 
s ure 1 7K by a triple asterisk ("*) beside Weeks 2308 and 
2326. 

[0087] Referring to Figure 5. in step 540. the Me 
system information Wock 2302 is flushed to disk, this is 
performed twice. Thus, fsinfo block 2302 is dirtied and 
10 then written to disk (indicated by a triple asterisk) in Fig- 
ure 17L In Figure 17L. a single fsinfo Wock 2302 is illus- 
trated. As shown in the diagram, fsinfo block 2302 now 
references Wock 2304 and 2308 of the inode file 2346. 
In Figure 17L, Wock 2306 is no longer part of the inode 
is file 2346 in the active file system. Similarly, file 2340 ref- 
erenced by inode 2308A of inode file 2346 comprises 
blocks 2310 and 2312. Block 2314 is no longer part of 
file 2340 in this consistency point. File 2342 comprises 
Wocks 2316, 2318. and 2322 in the new consistency 
20 point whereas Wock 2320 is not part of file 2342. Fur- 
ther, Wock 2308 of inode f ile 2346 references a new Wk- 
map file 2344 comprising block 2326. 
[0088] As shown in Figure 17L, in a consistency 
point the active file system is updated by copying the 
25 inode of the inode file 2346 into fsinfo Wock 2302. How- 
ever, the Wocks 2314. 2320, 2324, and 2306 of the pre- 
vious consistency point remain on disk. These Wocks 
are never overwritten when updating the f ile system to 
ensure that both the old consistency point 1 830 and the 
so new consistency point 1831 exist on disk in Figure 20 
during step 540 



SNAPSHOTS 

35 [0089] The WAFL system supports snapshots. A 
snapshot is a read-only copy of an entire file system at 
a given instant when the snapshot is created. A newly 
created snapshot refers to exactly the same disk Wocks 
as the active file system does. Therefore, it is created in 

40 a small period of time and does not consume any addi- 
tional disk space. Only as data Wocks in the active file 
system are modified and written to new locations on 
disk does the snapshot begin to consume extra space. 
[0090] WAFL supports up to 20 different snapshots 

« thatarenumbered1through20.Thus,WAFLallowsthe 
creation of multiple "clones" of the same file system. 
Each snapshot is represented by a snapshot inode that 
is similar to the representation of the active file system 
by a root inode. Snapshots are created by duplicating 

so the root data structure of the file system. In the preferred 
embodiment, the root data structure is the root mode. 
However, any data structure representative of an entire 
{He system could be used. The snapshot inodes reside 
in a fixed location in the inode file. The limit of 20 snap- 
55 shots is imposed by the size of the Wkmap entries. 
WAFL requires two steps to create a new snapshot N: 
copy the root inode into the inode for snapshot N; and. 
copy bit 0 into bit N of each Wkmap entry in the Wkmap 
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file. Bit 0 indicates the blocks that are referenced by the 
tree beneath the root inode. 

[0091 ] The result is a new file system tree rooted by 
snapshot inode N that references exactly the same disk 
blocks as the root inode. Setting a corresponding bit in 
the blkmap for each block in the snapshot prevents 
snapshot blocks from being freed even if the active file 
no longer uses the snapshot blocks. Because WAFL 
always writes new data to unused disk locations, the 
snapshot tree does not change even though the active 
file system changes. Because a newly created snap- 
shot tree references exactly the same blocks as the root 
inode, it consumes no additional disk space. Over time, 
the snapshot references disk blocks that would other- 
wise have been freed. Thus, over time the snapshot and 
the active file system share fewer and fewer blocks, and 
the space consumed by the snapshot increases. Snap- 
shots can be deleted when they consume unacceptable 
numbers of disk blocks. 

[0092] The list of active snapshots along with the 
names of the snapshots is stored in a metadata fOe 
called the snapshot directory. The disk state is updated 
as described above. As with all other changes, the 
update occurs by automatically advancing from one 
consistency pant to another. Modified blocks are written 
to unused locations on the disk after which a new root 
inode describing the updated file system is written. 

Overview of Snapshots 

[0093] Figure 18A is a diagram of the file system 
1830, before a snapshot is taken, where levels of indi- 
rection have been removed to provide a simpler over- 
view of the WAFL file system. The file system 1830 
represents the file system 1690 of Figure 16. The file 
system 1830 is comprised of blocks 1812-1820. The 
inode of the inode file is contained in fsinfo block 1810. 
While a single copy of the fsinfo block 1810 is shown in 
Figure 18A, it should be understood that a second copy 
of fsinfo block exists on disk. The inode 181 OA con- 
tained in the fsinfo block 1810 comprises 16 pointers 
that point to 1 6 blocks having the same level of indirec- 
tion. The blocks 1812-1820 in Figure 18A represent all 
blocks in the file system 1830 including direct blocks, 
indirect blocks, etc. Though only five blocks 1812-1820 
are shown, each block may point to other blocks. 
[0094] Figure 1 8B is a diagram illustrating the crea- 
tion of a snapshot The snapshot is made for the entire 
file system 1830 by simply copying the inode 1810A of 
the inode file that is stored in fsinfo block 1810 into the 
snapshot inode 1822. By copying the inode 181 OA of 
the inode ffle, a new file of inodes is created represent- 
ing the same file system as the active fOe system. 
Because the inode 181 OA of the inode fOe itself is cop- 
ied. No other blocks 1812-1820 need to be duplicated. 
The copied inode or snapshot inode 1822, is then cop- 
ied into the inode fOe that dirties a block in the inode f ila 
For an inode file conprised of one or more levels of indi- 



rection, each indirect block is in turn dirtied. This proc- 
ess of dirtying blocks propagates through all the levels 
of indirection. Each 4 KB block in the inode file on disk 
contains 32 inodes where each inode is 1 28 bytes long. 

5 [0095] The new snapshot inode 1 822 of figure 1 8B 
points back to the highest level of indirection blocks 
1812-1820 referenced by the inode 181 OA of the inode 
file when the snapshot 1822 was taken. The inode file 
itself is a recursive structure because it contains snap- 

10 shots of the file system 1 830. Each snapshot 1 822 is a 
copy of the inode 181 OA of the inode file that is copied 
into the inode file. 

[0096] Figure 18C is a diagram illustrating the 
active file system 1830 and a snapshot 1822 when a 

15 change to the active file system 1830 subsequently 
occurs after the snapshot 1822 is taken. As illustrated in 
the diagram, block 1818 comprising data "D" is modified 
after the snapshot was taken (in Figure 1 8B), and there- 
fore a new block 1824 containing data "Dp rim ©" is allo- 

20 cated for the active fOe system 1830. Thus, the active 
ffle system 1830 comprises blocks 1812-1816 and 
1820-1824 but does not contain block 1818 containing 
data '"D". However, block 1818 containing data "D" is 
not overwritten because the WAFL system does not 

25 overwrite blocks on disk. The block 1818 is protected 
against being overwritten by a snapshot bit that is set in 
the blkmap entry for block 1818. Therefore, the snap- 
shot 1822 still points to the unmodified block 1818 as 
well as blocks 1812-1816 and 1820. The present inven- 

30 tion, as illustrated in Figures 1 8A-1 8C, is unlike prior art 
systems that create "clones" of a file system where a 
clone is a copy of all the blocks of an inode file on disk. 
Thus, the entire contents of the prior art inode files are 
duplicated requiring large amounts (MB) of disk space 

35 as well as requiring substantial time for disk I/O opera- 
tions. 

[0097] As the active file system 1830 is modified in 
Figure 18C, it uses more disk space because the file 
system comprising blocks 1812-1820 is not overwritten. 

40 In Figure 18C, block 1818 is illustrated as a cfirect block. 
However, in an actual file system, block 1818 may be 
pointed to by indirect block as well. Thus, when block 
1818 is modified and stored in a new disk location as 
block 1824, the corresponding direct and indirect blocks 

45 are also copied and assigned to the active file system 
1830. 

[0098] Figure 19 is a diagram illustrating the 
changes occurring in block 1824 of Figure 18C. Block 
1824 of Figure 18C is represented within dotted line 

so 1 824 in Figure 1 9. Figure 1 9 illustrates several levels of 
indirection for block 1824 of Figure 18C. The new block 
1910 that is written to disk in Figure 18C is labeled 1910 
in Figure 19. Because block 1824 comprises a data 
block 1910 containing modified data that is referenced 

55 by double indirection, two other blocks 1918 and 1926 
are also modified. The pointer 1924 of single-indirect 
block 1918 references new block 1910, therefore block 
1 91 8 must also be written to disk in a new location. Sim- 
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ilarly, pointer 1928 of indirect block 1926 is modified 
because it points to block 1918. Therefore, as shewn in 
Figure 19, modifying a data block 1910 can cause sev- 
eral indirect blocks 1918 and 1926 to be modified as 
well. This requires blocks 1918 and 1926 to be written to 
disk in a new location as well. 
[0099] Because the direct and indirect blocks 1 91 0, 
1918 and 1926 of data block 1824 of Figure 18C have 
changed and been written to a new location, the inode 
in the inode file is written to a new block. The modified 
block of the inode file is allocated a new block on disk 
since data cannot be overwritten. 
[0100] As shown in Figure 19, block 1910 is pointed 
to by indirect blocks 1926 and 1918, respectively. Thus 
when block 1910 is modified and stored in a new disk 
location, the corresponding direct and indirect blocks 
are also copied and assigned to the active file system. 
Thus, a number of data structures must be updated. 
Changing direct block 1910 and indirection blocks 1918 
and 1926 causes the blkmap file to be modified. 
[0101] The key data structures for snapshots are 
the blkmap entries where each entry has multiple bits 
for a snapshot This enables a plurality of snapshots to 
be created. A snapshot is a picture of a tree of blocks 
that is the file system (1830 of Figure 18). As long as 
new data is not written onto blocks of the snapshot, the 
file system represented by the snapshot is not changed. 
A snapshot is similar to a consistency point 
[0102] The file system of the present invention is 
completely consistent as of the last time the fsinfo 
blocks 1810 and 1870 were written. Therefore, if power 
is interrupted to the system, upon restart the file system 
1830 comes up in a consistent state. Because 8-32 MB 
of disk space are used in typical prior art "done" of a 1 
GB file system, clones are not conductive to consist- 
ency points or snapshots as is the present invention. 
[0103] Referring to Figure 22, two previous snap- 
shots 2110A and 2110B exist on disk. At the instant 
when a third snapshot is created, the root inode pointing 
to the active file system is copied into the inode entry 
2110C for the third snapshot in the inode file 2110. At 
the same time in the consistency point that goes 
through, a flag indicates that snapshot 3 has been cre- 
ated. The entire file system is processed by checking if 
BIT0 for each entry in the blkmap file is set (1) or 
cleared (0). All the BIT0 values for each blkmap entry 
are copied into the plane for snapshot three. When 
completed, every active block 2110-2116 and 1207 in 
the file system is in the snapshot at the instant it is 
taken. 

[0104] Blocks that have existed on disk continu- 
ously for a given length of time are also present in cor- 
responding snapshots 2110A-2110B preceding the 
third snapshot 21 1 0C. If a block has been in the file sys- 
tem for a long enough period of time, it is present in all 
the snapshots. Block 1207 is such a block. As shown in 
Figure 22, block 1207 is referenced by inode 221 OQ of 
the active inode file, and indirectly by snapshots 1, 2 



and 3. 

[01 05] The sequential order of snapshots does not 
necessarily represent a chronological sequence of file 
system copies. Each individual snapshot in a file system 
5 can be deleted at any given time, thereby making an 
entry available for subsequent use. When BIT0 of a blk- 
map entry that references the active file system is 
cleared (indicating the block has been deleted from the 
active file system), the block cannot be reused if any of 
w the snapshot reference bits are set This is because the 
block is part of a snapshot that is still in use. A block can 
only be reused when all the bits in the blkmap entry are 
set to zero. 



15 Alnorithm for Q ftngrattnn a Snapshot 

[0106] Creating a snapshot is almost exactly like 
creating a regular consistency point as shown in Figure 
5. In step 510, all dirty inodes are marked as being in 
20 the consistency point. In step 520. all regular f Res are 
flushed to disk. In step 530. special files (i.e., the inode 
file and the blkmap file) are flushed to disk. In step 540, 
the fsinfo blocks are flushed to disk. In step 550, all 
inodes that were not in the consistency point are proc- 
25 essed. Figure 5 is described above in detail. In fact, cre- 
ating a snapshot is done as part of creating a 
consistency point. The primary difference between cre- 
ating a snapshot and a consistency point is that all 
entries of the blkmap file have the active FS-bit copied 
30 into the snapshot bit The snapshot bit represents the 
corresponding snapshot in order to protect the blocks in 
the snapshot from being overwritten. The creation and 
deletion of snapshot is performed in step 530 because 
that is the only point where the file system is completely 
35 self-consistent and about to go to disk. 

[0107] Different steps are performed in step 530 
then illustrated in Figure 6 for a consistency point when 
a new snapshot is created. The steps are very similar to 
those for a regular consistency point Figure 7 is a flow 
40 diagram illustrating the steps that step 530 comprises 
for creating a snapshot As described above, step 530 
allocates disk space for the blkmap file and the inode file 
and copies the active FS-bit into the snapshot bit that 
represents the corresponding snapshot in order to pro- 
45 tect the blocks in the snapshot from being overwritten. 
[01 08] In step 71 0, the inodes of the blkmap f He and 
the snapshot being created are pre-flushed to disk. In 
addition to flushing the inode of the blkmap file to a 
block of the inode file (as in step 610 of Figure 6 for a 
so consistency point), the inode of the snapshot being cre- 
ated is also flushed to a block of the inode file. This 
ensures that the block of the inode file containing the 
inode of the snapshot is dirty. 
[0109] In step 720. every block in the blkmap file is 
55 dirtied. In step 760 (described below), all entries in the 
blkmap file are updated instead of just the entries in 
dirty blocks. Thus, all blocks of the blkmap f ile must be 
marked dirty here to ensure that step 730 wrtte-allo- 
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cates disk space for them. 

[0110] In step 730, disk space is allocated for all 
dirty blocks in the inode and blkmap files. The dirty 
blocks include the block in the inode file containing the 
inode of the blkmap file, which is dirty, and the block s 
containing the inode for the new snapshot. 
[01 1 1 ] In step 740, the contents of the root inode for 
the f ile system are copied into the inode of the snapshot 
in the inode file. At this time, every block that is part of 
the new consistency point and that will be written to disk 10 
has disk space allocated for it. Thus, duplicating the root 
inode in the snapshot inode effectively copies the entire 
active file system. The actual blocks that will be in the 
snapshot are the same blocks of the active file system. 
[01 1 2] In step 750, the inodes of the blkmap file and is 
the snapshot are copied to into the inode file. 
[0113] In step 760, entries in the blkmap file are 
updated. In addition to copying the active FS-brt to the 
CP-bit for the entries, the active FS-bit is also copied to 
the snapshot bit corresponding to the new snapshot. 20 
[01 1 4] In step 770, all dirty blocks in the blkmap and 
inode files are written to disk. 
[01 1 5] Finally, at some time, snapshots themselves 
are removed from the file system in step 760. A snap- 
shot is removed from the file system by clearing its 25 
snapshot inode entry in the inode file of the active file 
system and clearing each bit corresponding to the 
snapshot number in every entry in the blkmap file. A 
count is performed also of each bit for the snapshot in 
all the blkmap entries that are cleared from a set value, 30 
thereby providing a count of the blocks that are freed 
(corresponding amount of disk space that is freed) by 
deleting the snapshot. Hie system decides which snap- 
shot to delete on the basis of the oldest snapshots. 
Users can also choose to delete specified snapshots 35 
manually. 

[01 1 6] The present invention limits the total number 
of snapshots and keeps a blkmap file that has entries 
with multiple bits for tracking the snapshots instead of 
using pointers having a COW bit as in Episode. An 40 
unused block has all zeroes for the bits in its blkmap file 
entry. Over time, the BITO for the active file system is 
usually turned on at some instant Setting BITO identifies 
the corresponding block as allocated in the active file 
system. As indicated above, all snapshot bits are initially 4$ 
set to zero. If the active file bit is cleared before any 
snapshot bits are set, the block is not present in any 
snapshot stored on disk. Therefore, the block is immedi- 
ately available for reallocation and cannot be recovered 
subsequently from a snapshot. so 

Generation of a Snapshot 

[0117] As described previously, a snapshot is very 
similar to a consistency point Therefore, generation of a 
snapshot is described with reference to the differences 
between it and the generation of a consistency point 
shown in Figures 17A-17L Figures 21A-21F illustrates 



the differences for generating a snapshot. 
[0118] Figures 17A-17D illustrate the state of the 
WAFL file system when a snapshot is begun. All dirty 
inodes are marked as being in the consistency point in 
step 510 and regular files are flushed to disk in step 
520. Thus, initial processing of a snapshot is identical to 
that for a consistency point. Processing for a snapshot 
differs in step 530 from that for a consistency point The 
following describes processing of a snapshot according 
to Figure 7. 

[0119] The following description is for a second 
snapshot of the WAFL file system. A first snapshot is 
recorded in the blkmap entries of Figure 17C. As indi- 
cated in entries 2324A-2324M, blocks 2304-2306, 
2310-2320, and 2324 are contained in the first snap- 
shot. All other snapshot bits (BIT1 -BIT20) are assumed 
to have values of 0 indicating that a corresponding 
snapshot does not exist on disk. Figure 21 A illustrates 
the file system after steps 510 and 520 are completed. 
[0120] In step 710, inodes 2308C and 2308D of 
snapshot 2 and blkmap file 2344 are pre-f lushed to disk. 
This ensures that the block of the inode file that is going 
to contain the snapshot 2 inode is dirty. In Figure 21 B, 
inodes 2308C and 2308D are pre-f lushed for snapshot 
2 and for blkmap file 2344. 

[0121] In step 720, the entire blkmap file 2344 is 
dirtied. This will cause the entire blkmap file 2344 to be 
allocated disk space in step 730. In step 730, disk space 
is allocated for dirty blocks 2308 and 2326 for inode file 
2346 and blkmap file 2344 as shown in Figure 21 C. This 
is indicated by a triple asterisk (***) beside blocks 2308 
and 2326. This is different from generating a consist- 
ency point where disk space is allocated only for blocks 
having entries that have changed in the blkmap file 
2344 in step 620 of Figure 6. Blkmap file 2344 of Figure 
21 C comprises a single block 2324. However, when blk- 
map file 2344 comprises more than one block, disk 
space is allocated for all the blocks in step 730. 
[0122] In step 740, the root inode for the new file 
system is copied into inode 2308D for snapshot 2. In 
step 750, the inodes 2308C and 2308D of blkmap file 
2344 and snapshot 2 are flushed to disk as illustrated in 
Figure 21 D. The diagram illustrates that snapshot 2 
inode 2308D references blocks 2304 and 2308 but not 
block 2306. 

[0123] In step 760, entries 2326A-2326L in block 
2326 of the blkmap file 2344 are updated as illustrated 
in Figure 21 E. The diagram illustrates that the snapshot 
2 bit (BIT2) is updated as well as the FS-BIT and CP- 
BIT for each entry 2326A-2326L Thus, blocks 2304, 
2308-2312, 2316-2318, 2322, and 2326 are contained 
in snapshot 2 whereas blocks 2306, 2314, 2320, and 
2324 are not In step 770, the dirty blocks 2308 and 
2326 are written to disk. 

[01 24] Further processing of snapshot 2 is identical 
to that for generation of a consistency point illustrated in 
Figure 5. In step 540, the two fsinfo blocks are flushed 
to disk. Thus, Figure 21 F represents the WAFL file sys- 
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tern in a consistent state after this step. Files 2340, 
2342, 2344, and 2346 of the consistent file system, after 
step 540 is completed, are indicated within dotted lines 
in Figure 21 F. In step 550, the consistency point is com- 
pleted by processing inodes that were not in the consist- 
ency point. 

focess Time Overwrites 

[0125] Unix file systems must maintain an "access 10 
time" (atime) in each mode. Atime indicates the last time 
that the file was read. It is updated every time the file is 
accessed. Consequently, when a file is read the block 
that contains the inode in the inode file is rewritten to 
update the mode. This could be disadvantageous for is 
creating snapshots because, as a consequence, read- 
ing a file could potentially use up disk space. Further, 
reading all the files in the file system could cause the 
entire inode file to be duplicated. The present invention 
solves this problem. 20 
[0126] Because of atime, a read could potentially 
consume disk space since modifying an inode causes a 
new block for the inode file to written on disk. Further, a 
read operation could potentially fail if a file system is full 
which is an abnormal condition for a file system to have 25 
occur. 

[0127] In general, data on disk is not overwritten in 
the WAFL file system so as to protect data stored on 
disk. The only exception to this rule is atime overwrites 
for an inode as illustrated in Figures 23A-23B. When an 30 
"atime overwrites" occurs, the only data that is modified 
in a block of the inode file is the atime of one or more of 
the inodes rt contains and the block is rewritten in the 
same location. This is the only exception in the WAFL 
system, otherwise new data is always written to new 35 
disk locations. 

[01 28] In Figure 23A, the atimes 2423 and 2433 of 
an inode 2422 in an old WAFL inode file block 2420 and 
the snapshot inode 2432 that references block 2420 are 
illustrated. Inode 2422 of block 2420 references direct 40 
block 2410. The atime 2423 of inode 2422 is "4/30 9:15 
PM" whereas the atime 2433 of snapshot inode 2432 is 
"5/1 10:00 AM". Figure 23A illustrates the file system 
before direct buffer 241 0 is accessed. 
[0129] Figure 23B illustrates the inode 2422 of 45 
direct block 2410 after direct block 2410 has been 
accessed. As shown in the diagram, the access time 
2423 of inode 2422 is overwritten with the access time 
2433 of snapshot 2432 that references it. Thus, the 
access time 2423 of inode 2422 for direct block 241 0 is so 
"5/1 1153 AM". 

[0130] Allowing inode file blocks to be overwritten 
with new atimes produces a slight inconsistency in the 
snapshot The atime of a file in a snapshot can actually 
be later than the time that the snapshot was created. In ss 
order to prevent users from detecting this inconsistency, 
WAFL adjusts the atime of all files in a snapshot to the 
time when the snapshot was actually created instead of 
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the time a file was last accessed. This snapshot time is 
stored in the inode that describes the snapshot as a 
whole. Thus, when accessed via the snapshot, the 
access time 2423 for inode 2422 is always reported as 
"5/1 10:00AM". This occurs both before the update 
when it may be expected to be "4/30 9:15PM", and after 
the update when it may be expected to be "5/1 
11 -23AM". When accessed through the active file sys- 
tem, the times are reported as "4/30 9:15PM" and "5/1 
1 1 :23AM" before and after the update, respectively. 
[0131] In this manner, a method is disclosed for 
maintaining a file system in a consistent state and for 
creating read-only copies of the file system. 

Claims 

1 . A method for recording a plurality of data about a 
plurality of blocks of data stored in storage means, 
the method comprising the steps of: 

maintaining a means for recording multiple 
usage bits per block of said storage means; 
storing, in said means for recording multiple 
usage bits per block, multiple bits for each of 
said plurality of said blocks of said storage 
means; and 

reusing at least one of said plurality of blocks of 
data in response to at least one of said multiple 
usage bits. 

2. A method for maintaining a file system comprising 
blocks of data stored in blocks of a non-volatile stor- 
age means at successive consistency points, the 
method comprising the steps of : 

storing a first file system information structure 
for a first consistency point in said non-volatile 
storage means, said first file system informa- 
tion structure comprising data describing a lay- 
out of said file system at said first consistency 
point of said file system; 
writing blocks of data of said file system that 
have been modified from said first consistency 
point as of the commencement of a second 
consistency point to free blocks of said non-vol- 
atile storage means; 

storing in said non-volatile storage means a 
second file system information structure for 
second consistency point, said second file sys- 
tem information structure comprising data 
describing a layout said file system at said sec- 
ond consistency point of said file system. 

3. A method according to claim 2, wherein said step of 
storing said first file system information structure in 
said non-volatile storage means comprises the step 
of: 
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storing first and second copies of said first file 
system information structure at first and sec- 
ond locations respectively of said non-volatile 
storage means; 

and wherein said step of storing said second 
file system information structure in said non- 
volatile storage means comprises the steps of: 
overwriting said first copy of said first file sys- 
tem information structure with a first copy of 
said second file system information structure; 
and 

overwriting said second copy of said first file 
system information structure with a second 
copy of said second file system information 
structure. 



usage bits per block of said non-volatile storage 
means. 

8. A method according to claim 7 wherein said means 
s for recording multiple usage bits per block of said 

non-volatile storage means comprises a block map 
comprising multiple bit entries for each block. 

9. A method according to claim 6, 7 or 8, wherein said 
10 meta-data comprises pointers to a hierarchical tree 

of blocks comprising said file system. 

10. A method according to claim 6, 7, 8 or 9, wherein 
said meta-data comprises structures representing 

15 files of said file system. 



4. A method according to claim 3, wherein said first 
and second locations of said non-volatile storage 
means comprise fixed predetermined locations of 
said non-volatile storage means. 

5. A method according to claim 3 or 4. wherein each 
copy of said ffle system information structure com- 
prises means for determining a most recent version 
of said file system information structure and means 
for determining validity of said file system informa- 
tion structure, the method further comprising the 
steps of: 

after a system failure, reading said first and 
second copies of said file system information 
structure from said first and second locations of 
said non-volatile storage means; 
determining a most recent valid file system 
information structure from said first and second 
copies of said file system information structure. 

6. A method for creating a plurality of read-only copies 
of a file system stored in blocks of a non-volatile 
storage means, said file system comprising meta- 
data identifying blocks of said non-volatile storage 
means used by said file system, the method com- 
prising the steps of: 

storing meta-data for successive states of said 
file system in said non-volatile storage means; 
making a copy of said meta-data at each of a 
plurality of said states of said file system; 
for each of said copies of said metadata at a 
respective state of said ffle system, marking 
said blocks of said non-volatile storage means 
identified in said metadata as comprising a 
respective read-only copy of said file system. 

7. A method according to claim 6, wherein said step of 
marking said blocks comprising a respective read- 
only copy of said ffle system comprises placing an 
appropriate entry in a means for recording multiple 



11. A method according to claim 10, wherein said 
structures representing files of said file system 
comprise modes. 

20 

12. A method according to any one of claims 6 to 1 1, 
further comprising the step of: 

preventing overwriting of said blocks marked as 
25 belonging to a read-only copy of said file sys- 

tem. 

13. A method according to any one of claims 6 to 12, 
comprising the step of unmarking said blocks 

30 marked as belonging to a read-only copy of said file 
system when said read-only copy of said file sys- 
tem is no longer needed. 

14. A method according to any one of claims 6 to 13, 
35 wherein a plurality of said blocks marked as belong- 
ing to a read-only copy of said file system comprise 
data ancillary to said file system, said method fur- 
ther including the steps of: 

40 allowing said ancillary data to be overwritten; 

and 

otherwise preventing overwriting of said blocks 
marked as comprising a read-only copy of said 
file system. 

45 

1 5. A method according to claim 1 4 wherein said ancil- 
lary data comprises access time data. 

16. A method according to any one of claims 6 to 15, 
so wherein said meta-data comprises a root structure 

referencing structures representing files of said file 
system, and wherein said copies of said meta-data 
comprise copies of said root structure. 

55 17. A method according to claim 16, wherein said root 
structure comprises a root inode. 

18. A method according to any one of claims 6 to 17, 
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further comprising the step of using one or more of 
said read-only copies of said file system to back-up 
said blocks comprising one or more consistency 
points of said file system. 

19. Apparatus for reading a plurality of blocks of data 
stored in storage means; the apparatus comprising: 

usage bit recording means for recording multi- 
ple usage bits for each block of said storage 
means; 

storing means for writing multiple bits per block 
of said storage means to said usage bit record- 
ing means; 

recording means for recording data to said 
storage means to reuse at least one of said plu- 
rality of blocks in response to at least one of 
said multiple usage bits. 

20. Apparatus for maintaining a file system comprising 
blocks of data stored in blocks of non-volatile stor- 
age means at successive first and second consist- 
ency points, the apparatus comprising: 

first storing means for storing in said non-vola- 
tile storage means a first file system informa- 
tion structure for a first consistency point, said 
first file system information structure compris- 
ing data describing a layout of said file system 
at said first consistency point thereof; 
writing means for writing blocks of data of said 
file system that have been modified from said 
first consistency point to free blocks of said file 
system; 

second storage means for storing in said non- 
volatile storage means a second file system 
information structure for said second consist- 
ency point, said second file system information 
structure comprising data describing a layout of 
said file system at said second consistency 
point of said f ile system. 

21 . Apparatus according to claim 20, wherein said first 
storing means is adapted to store first and second 
copies of said f irst f ile system information structure 
at first and second locations respectively; and said 
second storing means is adapted to overwrite said 
first and second copies of said first file system infor- 
mation structure with first and second copies of 
said second file system information structure. 

22. Apparatus for creating a plurality of read-only cop- 
ies of a file system stored in blocks of a non-volatiie 
storage means, said file system comprising meta- 
data identifying blocks of said non-volatile storage 
means used by said file system, the apparatus 
comprising: 
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storing means for storing metadata for succes- 
sive states of said file system in said non-vola- 
tile storage means; 

copying means for making a copy of said meta- 
data at each of a plurality of said states of said 
file system; and 

marking means, operative for each of said cop- 
ies of said meta-data. for marking said blocks 
identified in said meta-data as comprising a 
respective read-only copy of said file system. 
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